Send Your First API Request

Once your environment is set up, you’re ready to send your first request to the Euclid API. This page covers both GraphQL and REST examples using common tools and languages.

GraphQL Example

Let’s fetch a list of all tokens available through the Euclid router.

GraphQL Query

query Router {
  router {
    all_tokens {
      tokens
    }
  }
}

# index.sh
curl -X POST https://testnet.api.euclidprotocol.com/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"query Router { router { all_tokens { tokens } } }"}'

// App.js
import React, { useEffect } from 'react';
import { ApolloClient, InMemoryCache, HttpLink, gql } from '@apollo/client';

const client = new ApolloClient({
  link: new HttpLink({ uri: 'https://testnet.api.euclidprotocol.com/graphql' }),
  cache: new InMemoryCache(),
});

function App() {
  useEffect(() => {
    client
      .query({
        query: gql`
          query Router {
            router {
              all_tokens {
                tokens
              }
            }
          }
        `,
      })
      .then((result) => {
        console.log('API Response:', result.data);
      })
      .catch((error) => {
        console.error('Error:', error);
      });
  }, []);

  return <h1>Check the browser console for the API response</h1>;
}

export default App;

// index.js
const { ApolloClient, InMemoryCache, gql, HttpLink } = require('@apollo/client/core');
const fetch = require('cross-fetch');

const client = new ApolloClient({
  link: new HttpLink({
    uri: 'https://testnet.api.euclidprotocol.com/graphql',
    fetch
  }),
  cache: new InMemoryCache(),
});

client.query({
  query: gql`
    query Router {
      router {
        all_tokens {
          tokens
        }
      }
    }
  `
}).then(result => {
  console.log(JSON.stringify(result.data, null, 2));
}).catch(err => {
  console.error('Error:', err);
});

# Use this directly in your GraphQL playground

query Router {
  router {
    all_tokens {
      tokens
    }
  }
}

REST Example

Let’s track the status of a transaction on the somnia chain using the REST API.

Endpoint

POST https://testnet.api.euclidprotocol.com/api/v1/txn/track

# index.sh
curl -X 'POST' \
  'https://testnet.api.euclidprotocol.com/api/v1/txn/track' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "chain": "somnia",
    "tx_hash": "0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9"
}'

// index.js
fetch('https://testnet.api.euclidprotocol.com/api/v1/txn/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'accept': 'application/json'
  },
  body: JSON.stringify({
    chain: 'somnia',
    tx_hash: '0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9'
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

// index.js
const axios = require('axios');

axios.post('https://testnet.api.euclidprotocol.com/api/v1/txn/track', {
  chain: 'somnia',
  tx_hash: '0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9'
}, {
  headers: {
    'Content-Type': 'application/json',
    'accept': 'application/json'
  }
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

# index.py
import requests

url = "https://testnet.api.euclidprotocol.com/api/v1/txn/track"
headers = {
  "accept": "application/json",
  "Content-Type": "application/json"
}
data = {
  "chain": "somnia",
  "tx_hash": "0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

# Use this as a Postman raw JSON body

{
  "method": "POST",
  "url": "https://testnet.api.euclidprotocol.com/api/v1/txn/track",
  "headers": [
    {
      "key": "Content-Type",
      "value": "application/json"
    },
    {
      "key": "accept",
      "value": "application/json"
    }
  ],
  "body": {
    "mode": "raw",
    "raw": "{\n  \"chain\": \"somnia\",\n  \"tx_hash\": \"0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9\"\n}"
  }
}